==============
Reporting bugs
==============

If you encounter a bug, please be so kind and take the time to report it.

Preferably, you submit that report to the `bug tracker`_,
but you are welcome to write me an :doc:`email <contact>`, too.

Please include:

* What system you use (as shown by :command:`uname -r`)

* Your Python version (as shown by :command:`python3 --version`)

* Steps to reproduce the issue, if possible

* What you were trying to do

* Why you were trying to do that

* What you expected to happen

* What actually happened

* Debugging output (enable with :option:`-d`)

.. admonition:: Enabling debugging output in Python

    .. code:: python

        import logging
        logging.getLogger().setLevel(logging.DEBUG)


.. _`bug tracker`: https://github.com/odkr/sievemgr/issues
